home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / ARCHIVE / JRC.ZIP / JRCHIVE.DOC < prev    next >
Encoding:
Text File  |  1993-11-01  |  44.8 KB  |  1,555 lines

  1.  
  2.  
  3.                                                                             
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                     JRchive
  16.  
  17.  
  18.                               File Archiving and
  19.  
  20.                              Compression Software
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                  User's Manual
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                                  JAYAR Systems
  52.                               253 College Street
  53.                                    Suite 263
  54.                                Toronto, Ontario
  55.                                Canada   M5T 1R5
  56.                                 (416) 751-5678
  57.  
  58.  
  59.                                        
  60.  
  61.  
  62.  
  63.                                                                             
  64.  
  65.  
  66.                                     LICENSE
  67.  
  68.         The license for the Shareware evaluation (trial use) version of
  69.   JRchive is contained in the file LICENSE.DOC. This file has been included
  70.   for your convenience as an appendix to this manual.
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.                                    WARRANTY
  79.  
  80.         The Shareware evaluation (trial use) version of JRchive is provided
  81.   AS IS. JAYAR Systems MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED,
  82.   INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY AND/OR
  83.   FITNESS FOR A PARTICULAR PURPOSE.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.                                 SUPPORT POLICY
  92.  
  93.         JAYAR Systems provides free support for this product. We will answer
  94.   questions and fix serious bugs. If you have any questions about or problems
  95.   with using this product, give us a call at the number on the front cover of
  96.   this manual. Or, if you are not in a rush, send us a letter.
  97.  
  98.         We would also appreciate hearing from you if you have any comments or
  99.   suggestions for improvements.
  100.  
  101.  
  102.  
  103.  
  104.  
  105.                      _______                    
  106.                 ____|__     |               (R) 
  107.              --|       |    |-------------------
  108.                |   ____|__  |  Association of   
  109.                |  |       |_|  Shareware        
  110.                |__|   o   |    Professionals    
  111.              -----|   |   |---------------------
  112.                   |___|___|    MEMBER           
  113.  
  114.  
  115.                   JRchive Copyright (C) 1992-93 JAYAR Systems
  116.                               All Rights Reserved
  117.  
  118.  
  119.                                        
  120.  
  121.  
  122.  
  123.                                                                             
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                    CONTENTS
  132.  
  133.  
  134.  
  135.   1      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . .    1
  136.   2      Using JRchive . . . . . . . . . . . . . . . . . . . . . . . . .    3
  137.   3      Installing JRchive  . . . . . . . . . . . . . . . . . . . . . .    4
  138.   4      Creating archives with JRC  . . . . . . . . . . . . . . . . . .    5
  139.             Options  . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  140.             Arguments  . . . . . . . . . . . . . . . . . . . . . . . . .    6
  141.             Examples . . . . . . . . . . . . . . . . . . . . . . . . . .    6
  142.   5      Listing archives with JRCL  . . . . . . . . . . . . . . . . . .    8
  143.   6      Extracting files with JRCE  . . . . . . . . . . . . . . . . . .    9
  144.             Options  . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  145.             Arguments  . . . . . . . . . . . . . . . . . . . . . . . . .    9
  146.             Examples . . . . . . . . . . . . . . . . . . . . . . . . . .   10
  147.   7      Creating self-extracting archives with SELFEX . . . . . . . . .   11
  148.   8      DOS--UNIX transfers . . . . . . . . . . . . . . . . . . . . . .   12
  149.   A      Caveat  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  150.   B      Error messages  . . . . . . . . . . . . . . . . . . . . . . . .   14
  151.   C      License . . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  152.   D      Trial Use License:  . . . . . . . . . . . . . . . . . . . . . .   17
  153.   E      Limited Distribution License: . . . . . . . . . . . . . . . . .   18
  154.   F      Definition of Shareware . . . . . . . . . . . . . . . . . . . .   20
  155.   G      How to Register . . . . . . . . . . . . . . . . . . . . . . . .   21
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                                      iii
  179.  
  180.  
  181.  
  182.  
  183.                                                                             
  184.  
  185.  
  186.  
  187.  
  188.  
  189.                                 1 Introduction 
  190.  
  191.  
  192.   JRchive is a system for compressing and archiving files. The process of
  193.   archiving files involves packing a number of separate files into one
  194.   _______                                                                   
  195.   archive file. As the files are added to the archive they may be compressed
  196.   so that the archive file takes less space on disk than the individual files
  197.   do.
  198.  
  199.         Actually there are two ways of compressing files in an archive. You
  200.   may have some or all of your files compressed as you add them to the
  201.   archive, or the files can be added to the archive in an uncompressed form
  202.                                                                 ____________
  203.   and the archive as a whole compressed. The latter is called a concatenated
  204.   _______                                                                   
  205.   archive; it can save even more space if the archive consists of many small
  206.   files or files with similar characteristics.
  207.  
  208.         What kinds of files can be compressed? Just about anything. Text
  209.   files usually yield the best compression ratios--50% or better. Binary
  210.   files such as executables will compress as well but not by so much. Only
  211.   files with completely random data (which are quite rare) or files that have
  212.   already been compressed will not be reduced in size.
  213.  
  214.         Why would you want to create an archive? There a number of good
  215.   reasons:
  216.  
  217.     o Archives are convenient for storing related files. It is easier to
  218.       copy, transport and keep track of one file than many.
  219.  
  220.     o If the archive is compressed it can save you a great deal of space on
  221.       your hard disk or on floppies.
  222.  
  223.     o A compressed archive can be transmitted by modem much faster and easier
  224.       than the individual files can be.
  225.  
  226.     o If you are a software developer or if you send files on diskette to
  227.       your friends and associates then JRchive is ideal. You can pack more
  228.       files on to fewer diskettes. You can distribute the extraction program
  229.       without restriction with your archives. Or, you can create a
  230.       self-extracting archive. The end user executes the archive like a
  231.       program and it extracts its component files automatically. You can also
  232.       include a display file in the archive which will display a message to
  233.       the user while extraction is taking place. Otherwise extraction
  234.       proceeds quietly.
  235.  
  236.     o JRchive is available for the DOS and UNIX operating systems. Compressed
  237.       archives can be transmitted between these two operating systems by
  238.       network or modem faster and with less effort than individual files can
  239.       be.
  240.  
  241.  
  242.                                       1
  243.  
  244.  
  245.  
  246.                                                             Introduction   2
  247.  
  248.  
  249.         JRchive consists of a suite of four programs, described briefly in
  250.   section 3. One section of this manual is devoted to describing each program
  251.   and its use. The programs are easy to use and the manual is short. Spend a
  252.   few minutes with it and you will be able to use all the features of
  253.   JRchive.
  254.  
  255.         The programs in JRchive use a UNIX-style command line interface: the
  256.   program name, followed by zero or more one-letter options each preceded by
  257.   a - sign, followed by one or more arguments.
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.                                                            Using JRchive   3
  307.  
  308.  
  309.  
  310.  
  311.  
  312.                                2 Using JRchive 
  313.  
  314.  
  315.         JRchive comprises four separate programs. In this section we will
  316.   just present the purpose of each of the programs. More detailed information
  317.   will be given in following sections.
  318.  
  319.         JRC is the program which creates an archive or adds files to an
  320.   existing archive. You use this program to compress and archive your files.
  321.  
  322.         JRCE is the companion program which extracts files from an archive.
  323.   You may extract all or just some of the files in an archive.
  324.  
  325.         JRCL is a program which shows you what programs are in an archive and
  326.   gives you information on their size, format and modification date.
  327.  
  328.         Finally, SELFEX is a version of JRCE which is not used directly by
  329.   itself but which is used to build a self-extracting archive.
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.                                                       Installing JRchive   4
  367.  
  368.  
  369.  
  370.  
  371.  
  372.                              3 Installing JRchive 
  373.  
  374.  
  375.   Installation of JRchive couldn't be easier. The distribution diskette
  376.   contains the four programs described in Section  and a file called README
  377.   which you should check for any last minute updates which did not make this
  378.   manual.
  379.  
  380.         The distribution diskette is not copy protected so you can copy the
  381.   programs to your hard disk--a good location would be the directory where
  382.   you keep your utilities. It should be a directory that is pointed to by
  383.   your PATH environment variable so they will be easy to use.
  384.  
  385.         It is also possible to use any of the JRchive programs from a floppy
  386.   diskette. A feature of JRchive is that the component programs are quite
  387.   small and don't require a lot of memory or disk space so they are
  388.   convenient to use even from a diskette.
  389.  
  390.         In any event, don't execute the programs from the distribution
  391.   diskette. Copy them to another disk and put the distribution diskette away
  392.   in a safe place.
  393.  
  394.         To install JRchive on a UNIX system, see the file BUILD.DOC on the
  395.   distribution diskette.
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.                                               Creating archives with JRC   5
  427.  
  428.  
  429.  
  430.  
  431.  
  432.                          4 Creating archives with JRC 
  433.  
  434.  
  435.         An archive is a file that contains one or more component files. You
  436.   use the program JRC to create an archive. By default JRC will attempt to
  437.   compress files as it adds them to the archive. If a file cannot be
  438.   compressed then it will be added in an uncompressed form. You can specify
  439.   that JRC not attempt file compression when adding files.
  440.  
  441.         Why would you want to forego compression? If you don't care about the
  442.   size of the archive then suppressing compression will save time. Or, if you
  443.   are archiving files that are already compressed such as graphics
  444.   interchange format (gif) files you should suppress compression. JRC will
  445.   attempt to compress these files even though it will not be able to, thereby
  446.   wasting a lot of time.
  447.  
  448.                                                ____________ _______         
  449.         You can also specify that JRC create a concatenated archive. In this
  450.   case JRC builds the archive by adding files to it in an uncompressed
  451.   form--it then compresses the entire archive as a unit. The advantage of a
  452.   concatenated archive is that it can achieve better compression ratios,
  453.   depending on the nature of the files in the archive, than is possible by
  454.   compressing the files individually. This is especially true if the files
  455.   are small or have similar characteristics; JRC can detect pattern
  456.   repetition across the entire archive. The disadvantage of a concatenated
  457.   archive is that it cannot be extended, i.e., you can't add more files to it
  458.   later.
  459.  
  460.         The syntax for executing JRC is
  461.  
  462.                           _______           ________            ________      
  463.   jrc [-v] [-N] [-c] [-u] archive [-n] [-d] filespec [[-n] [-d] filespec ... ]
  464.  
  465.         JRC uses a UNIX-style command line syntax; program action is modified
  466.   by including options preceded by - signs. Items in square brackets are
  467.   optional.
  468.  
  469.  
  470.   Options 
  471.  
  472.         There are four global options which apply to all files in the archive
  473.   and two local options which apply only to the immediately following file
  474.   specifiers.
  475.  
  476.       -v is the verbose option. Normally JRC runs quietly. The -v option will
  477.       cause it to display the name of every file added to the archive as well
  478.       as the compressed size of the file expressed as a percentage of its
  479.       original size.
  480.  
  481.       -N is the global non-compression option. Including this option prevents
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.                                               Creating archives with JRC   6
  489.  
  490.  
  491.       JRC from compressing any of the files added to the archive in this
  492.       invocation of the program.
  493.  
  494.       -c is the concatenated archive option. This causes JRC to create a
  495.       concatenated archive as defined at the beginning of this section. This
  496.       option is not valid with an existing archive--it can only be specified
  497.       for new archives.
  498.  
  499.       -u is the UNIX transfer option. It should be specified when creating a
  500.       text file archive on DOS that will unpacked on UNIX.
  501.  
  502.       -n is the local non-compression option. This option is included before
  503.       a file specification and suppresses compression of the files selected
  504.       by the immediately following file specification.
  505.  
  506.       -d is the display option. Files preceded by this option are added to
  507.       the archive as any other file, however, they are flagged in the archive
  508.       as display files. When files are extracted from the archive the display
  509.       file(s) is displayed on the user's terminal--it is not extracted. Use
  510.       this option if you want to display a message when extraction is taking
  511.       place.
  512.  
  513.  
  514.   Arguments 
  515.  
  516.         _______                                                            
  517.         archive is the name of the archive file. If the file does not exist
  518.   it is created. If the file exists and is a valid JRchive archive then files
  519.   will be added to it.
  520.  
  521.         ________                                                           
  522.         filespec is a file specification. There may be more than one on the
  523.   command line. Wildcard characters are permitted in a file specification and
  524.   have the usual effect. You can include a full pathname for a file but not
  525.   in combination with filenames containing wildcard characters. In any event
  526.   only the file name portion is stored. This means that when you extract the
  527.   file from the archive it is recreated in the current directory. JRchive
  528.   will not recreate directory trees.
  529.  
  530.  
  531.   Examples 
  532.  
  533.        jrc -c -v source.jrc *.c *.h
  534.  
  535.         This example creates a concatenated archive file called SOURCE.JRC.
  536.   It will contain all files in the current directory with extensions .c and
  537.   .h.
  538.  
  539.        jrc -v text -d message -n header a:*.txt
  540.  
  541.         This example creates an archive file called TEXT. It contains the
  542.   display file MESSAGE which will be printed when files are extracted from
  543.   the archive, a file called HEADER which will not be compressed when it is
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.                                               Creating archives with JRC   7
  551.  
  552.  
  553.   added to the archive, and all the files in the current directory on drive
  554.   A: with extension .TXT. These files will be compressed.
  555.  
  556.         In both examples the verbose option is specified so that file names
  557.   and compression ratios will be printed out as files are added to the
  558.   archive.
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.                                               Listing archives with JRCL   8
  611.  
  612.  
  613.  
  614.  
  615.  
  616.                          5 Listing archives with JRCL 
  617.  
  618.  
  619.         JRCL is the program which shows you what files are in an archive. The
  620.   syntax for executing JRCL is
  621.  
  622.              _______  ______ 
  623.         jrcl archive [target]
  624.  
  625.                                       _______                          
  626.         JRCL prints for every file in archive its name, whether it is a
  627.   compressed or display file, its size in bytes (its compressed size if it is
  628.   compressed), and the file's time stamp. The time stamp is the date and time
  629.   of the file's last modification as supplied by DOS.
  630.  
  631.         JRCL behaves somewhat differently if you include a target file
  632.   specification. In this case it only lists those files in the archive that
  633.         ______                                                            
  634.   match target. Upper case letters are treated the same as lower case when
  635.              ______                                              
  636.   specifying target and partial matches are allowed. For example,
  637.  
  638.         jrcl source input.f
  639.  
  640.   will list the entry for the file INPUT.F if it is in the archive SOURCE. It
  641.   will also list the entry for INPUT.FOR (or for that matter INPUT.F??) if it
  642.   is in the archive as well.
  643.  
  644.         jrcl source a
  645.  
  646.         will list all the files in the archive beginning with the letter A.
  647.  
  648.         JRCL cannot list the files in a concatenated archive as the archive
  649.   would have to be uncompressed first.
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.                                               Extracting files with JRCE   9
  675.  
  676.  
  677.  
  678.  
  679.  
  680.                          6 Extracting files with JRCE 
  681.  
  682.  
  683.         JRCE is the program you use for extracting files from an archive. If
  684.   the files were compressed when added to the archive they will be
  685.   uncompressed automatically. Concatenated archives are also handled
  686.   automatically by JRCE and in all respects you treat them the same as a
  687.   normal archive. The syntax for executing JRCE is
  688.  
  689.                                  _______  ______ 
  690.         jrce [-v] [-t] [-l] [-u] archive [target]
  691.  
  692.         If invoked without the optional target argument JRCE extracts all of
  693.   the files in the archive into your current directory. If JRCE encounters a
  694.   display file (see Section ) in the archive it prints out the display file
  695.   on the user's screen, otherwise it produces no screen output unless the -v
  696.   option is selected. If JRCE finds a file in the archive with the same name
  697.   as one in the current directory it will ask you if you want to overwrite
  698.   the file in the current directory. Replying with a Y or y will cause the
  699.   file to be overwritten; replying with any other letter (including just a
  700.   <RETURN>) will prevent that file from being extracted from the archive.
  701.  
  702.         Note that you may freely distribute JRCE.EXE (and only JRCE.EXE) with
  703.   your archive files to enable others to extract files from them.
  704.  
  705.  
  706.   Options 
  707.  
  708.  
  709.       -v is the verbose option. Normally JRCE extracts files from the archive
  710.       quietly. If you include this option it will display the file name and
  711.       original time stamp of each file it extracts from the archive.
  712.  
  713.       -t is the time stamp option. By default when JRCE extracts a file from
  714.       an archive it restores the file's time stamp (the date and time the
  715.       file was last modified--supplied by the operating system) that it
  716.       picked up when it archived the file. If you include this option JRCE
  717.       will use the current date and time as the file's time stamp.
  718.  
  719.       -l is the lowercase option. On a UNIX system this forces the filenames
  720.       of restored files to consist of all lowercase letters. Otherwise, files
  721.       that were archived on a DOS system may be restored with uppercase
  722.       names.
  723.  
  724.       -u is the UNIX option. You should specify this option on DOS systems
  725.       when unpacking text file archives that were created on a UNIX system.
  726.  
  727.  
  728.   Arguments 
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.                                              Extracting files with JRCE   10
  736.  
  737.  
  738.         _______                                                             
  739.         archive is the name of the archive file from which JRCE will extract
  740.   files. These files will be recreated in the current directory. It is not
  741.   necessary for the archive file to be in the current directory.
  742.  
  743.         ______                                                           
  744.         target is a file selector which may be used to restrict the files
  745.                           _______                                          
  746.   that JRCE extracts from archive. Normally JRCE extracts all files from an
  747.                           ______                                            
  748.   archive. If you include target as an argument JRCE will only extract those
  749.                           ______                                           
  750.   files whose names match target. Upper case and lower case are treated the
  751.                      ______                                 
  752.   same in specifying target and partial matches are allowed.
  753.  
  754.         If you include a target then any display files in the archive will
  755.                                    ______                       ______       
  756.   not be printed unless they match target. Also, files matching target
  757.   be extracted regardless of whether or not there is a file of the same name
  758.   in the current directory--you will not be asked to confirm first.
  759.  
  760.  
  761.   Examples 
  762.  
  763.         jrce -v -t arch.jrc
  764.  
  765.         will extract all files from the archive file ARCH.JRC. As the files
  766.   are extracted their names and original time stamps will be displayed on the
  767.   screen. The files' time stamps will be set to the current date and time
  768.   however.
  769.  
  770.         jrce source.jrc abc
  771.  
  772.         will extract any files whose names begin with the letters ABC from
  773.   the archive file SOURCE.JRC. The extraction will proceed quietly.
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.                           Creating self-extracting archives with SELFEX   11
  803.  
  804.  
  805.  
  806.  
  807.  
  808.                7 Creating self-extracting archives with SELFEX 
  809.  
  810.  
  811.         If you are using JRchive to create archives for distribution it can
  812.   be inconvenient to distribute the JRCE program along with the archive and
  813.   explain its use. If you are a software developer this can add another layer
  814.   of confusion to the distribution and installation process.
  815.  
  816.                                         _______________ _______           
  817.         In this case what you need is a self-extracting archive. This is a
  818.   program that the user runs--it contains an archive and extracts its
  819.   contents as it runs. To construct a self-extracting archive you need the
  820.   SELFEX file distributed as part of the DOS version of JRchive. SELFEX is
  821.   not available for UNIX systems.
  822.  
  823.         We will explain how to create a self-extracting archive with an
  824.   example. Suppose you want to distribute a software system consisting of
  825.  
  826.     o two programs, ONE.EXE and TWO.EXE,
  827.  
  828.     o a documentation file called DOC.TXT,
  829.  
  830.     o a file containing late developments called READ.ME
  831.  
  832.     o a file that contains a message for the user to read while the files are
  833.       extracting called MESSAGE.TXT.
  834.  
  835.         First archive the files:
  836.  
  837.         jrc -v arch -d message.txt read.me one.exe two.exe doc.txt
  838.  
  839.         This creates an archive file called ARCH (you can use any name). Now
  840.   convert this to a self-extracting archive:
  841.  
  842.         copy/b selfex+arch mysystem.exe
  843.  
  844.         This uses the DOS COPY command to paste SELFEX and your archive file
  845.   together in one file called MYSYSTEM.EXE. Important points to note are that
  846.   you must include the /B switch on COPY and the output file must have an
  847.   extension of .EXE.
  848.  
  849.         Now you just send the MYSYSTEM.EXE (you can use any name in place of
  850.   MYSYSTEM) file to your users. When a user runs this program by typing
  851.  
  852.         mysystem
  853.  
  854.         the material in MESSAGE.TXT is displayed on the screen and the files
  855.   ONE.EXE, TWO.EXE, DOC.TXT and READ.ME are created in the current directory.
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.                                                     DOS--UNIX transfers   12
  864.  
  865.  
  866.  
  867.  
  868.  
  869.                             8 DOS--UNIX transfers 
  870.  
  871.  
  872.         JRchive is available for both DOS and UNIX systems and provides a
  873.   very convenient means of transferring files between the two operating
  874.   systems.
  875.  
  876.         Some precautions must be taken when transferring text files between
  877.   the two systems though. This is because UNIX uses a single character to
  878.                 _______                                                      
  879.   represent the newline character while DOS uses a two-character combination.
  880.   For this reason archives created on one system for transfer to the other
  881.   should consist of all text files (i.e., human-readable) or all binary files
  882.   (i.e., non-readable)--do not mix the two.
  883.  
  884.         If the software you are using to exchange files between DOS and UNIX
  885.   (e.g., KERMIT, ftp, etc.) has a "binary" file transfer mode, be sure to use
  886.   it. Note that the default file transfer mode is usually "ascii" or
  887.   "text"--this mode will not give correct results even if the archive
  888.   consists solely of text files.
  889.  
  890.         For specific transfers between the two operating systems, use the
  891.   following guidelines:
  892.  
  893.     o Binary file archives; DOS to UNIX or UNIX to DOS: No special
  894.       requirements. These archives can be created and extracted on both
  895.       systems.
  896.  
  897.     o Text file archives; DOS to UNIX: Use the -u option when creating the
  898.       archive with JRC on DOS. Run JRCE in the usual way on UNIX to extract
  899.       files from the archive. Use the -l option for JRCE if you want the file
  900.       names in lowercase letters (DOS considers all file names to be in
  901.       upppercase letters).
  902.  
  903.     o Text file archives; UNIX to DOS: Create the archive in the usual way
  904.       with JRC on UNIX. Use the -u option when extracting files from the
  905.       archive on DOS.
  906.  
  907.       Note that you can use jrce -u ... to extract files on DOS from an
  908.       archive that was created on DOS with jrc -u ....
  909.  
  910.         In summary, when exchanging binary files between the systems, no
  911.   special procedure is required; when exchanging text files, use the -u
  912.   option on the DOS programs. The -u option is not recognized on the UNIX
  913.   versions of the programs.
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.                                                                  Caveat   13
  925.  
  926.  
  927.  
  928.  
  929.  
  930.                                    A Caveat 
  931.  
  932.  
  933.         We have taken a lot of care in the development of JRchive and we are
  934.   reasonably sure that it is bug-free. However, it is the nature of computer
  935.   software that you can never test it completely and certainly not against
  936.   all possible inputs. There is always the possibility, however remote, that
  937.   a particular input can cause one of the programs to fail.
  938.  
  939.         Therefore, if you compress important or difficult-to-reproduce files
  940.   into an archive, you should extract them from the archive and compare them
  941.   to the originals. Use the DOS COMP or UNIX cmp command to perform the
  942.   comparison. To do this you will need to rename the original files or
  943.                                                          __ ____ ___ _______
  944.   extract the archived files into a different directory. Be sure you perform
  945.   ____ __________ ______ ___ ______ ___ ________ ______                     
  946.   this comparison before you delete the original files. For example, say you
  947.   want to compress the file VALUABLE.FIL into the archive file SAVE and make
  948.   sure you can uncompress VALUABLE.FIL before deleting the original. On DOS,
  949.   you would execute the following:
  950.  
  951.         jrc save valuable.fil
  952.         ren valuable.fil valuable.old 
  953.         jrce save valuable.fil 
  954.         comp valuable.fil valuable.old 
  955.  
  956.         If the compare shows the files to be identical, then type
  957.  
  958.         del valuable.*
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.                                                          Error messages   14
  987.  
  988.  
  989.  
  990.  
  991.  
  992.                                B Error messages 
  993.  
  994.  
  995.         This section describes the error messages that the JRchive programs
  996.   may produce and offers suggestions on how to remedy the problems they
  997.   indicate.
  998.  
  999.                        ____ 
  1000.         Invalid option -opt]
  1001.   An undefined program option (a minus sign followed by a letter) was
  1002.   specified. Type the program name alone without options or arguments and it
  1003.   will list the valid options.
  1004.  
  1005.         -c option invalid with existing archive
  1006.   The concatenated archive option was specified with an existing archive. An
  1007.   existing archive can be extended, but the concatenated option cannot be
  1008.   used. Concatenated archives are created in one step and cannot be extended.
  1009.  
  1010.         ________                                     
  1011.         filename exists and is a concatenated archive
  1012.   The archive file already exists but it cannot be extended because it is a
  1013.   concatenate archive. Ordinary archives can be extended; concatenated
  1014.   archives are created in one step and cannot be extended.
  1015.  
  1016.         ________                              
  1017.         filename is not a JRchive archive file
  1018.   The file specified as an archive file exists but is not an archive file. An
  1019.   attempt was made to extend it, unpack it or list its contents.
  1020.  
  1021.         ________                    
  1022.         filename: not a regular file
  1023.   The named file was to be added to an archive, but it is not a regular
  1024.   file--most likely it is a directory.
  1025.  
  1026.                          ________          ____  
  1027.         Cannot open file filename for mode mode
  1028.   The named file--either an archive or file to be added to an archive cannot
  1029.   be opened. Check to see that its path was specified properly.
  1030.  
  1031.         ________                           
  1032.         filename: No such file or directory
  1033.   The file specified to be added to an archive does not exist in the current
  1034.   directory. When building an archive you must execute JRC from the directory
  1035.   in which the files to be added reside. The archive file itself may reside
  1036.   in a different directory.
  1037.  
  1038.              ________                 
  1039.         File filename cannot be opened
  1040.   The named archive file cannot be found--check to make sure you have
  1041.   specified the path correctly.
  1042.  
  1043.                                    ________          ____  
  1044.         Cannot open temporary file filename for mode mode
  1045.   The JRchive programs use temporary files for building and unpacking
  1046.   archives. This error likely means that there is not enough space on the
  1047.   device (perhaps a floppy disk) to open one.
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.                                                          Error messages   15
  1055.  
  1056.  
  1057.         Unable to allocate memory
  1058.   One of the programs was unable to allocate memory for its internal tables.
  1059.   You should never see this error--if you do, please contact JAYAR Systems.
  1060.  
  1061.         The following errors indicate that JRCE is unable to proceed with
  1062.   decompression or unpacking of an archive file. These will only occur if the
  1063.   archive file has been corrupted or partially overwritten.
  1064.  
  1065.         Stack overflow in expansion
  1066.  
  1067.         Premature end of data
  1068.  
  1069.         End of data
  1070.  
  1071.                           _  
  1072.         Invalid file code c
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.                                                                 License   16
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.                                   C License 
  1122.  
  1123.  
  1124.         This appendix contains important license information regarding the
  1125.   use of JRchive, Version 1.02. This information applies to individual users
  1126.   who wish to pass copies out to friends and associates.
  1127.  
  1128.         User Groups, Computer Clubs, Disk Vendors and Distributors,
  1129.   Subscription Services, Disk-of-the-Month Clubs, etc., should refer to the
  1130.   VENDOR.DOC file for complete information relating to them.
  1131.  
  1132.         BBS SYSOPs should refer to the SYSOP.DOC file for complete
  1133.   information relating to them.
  1134.  
  1135.         PLEASE! Show your support for Shareware by registering the programs
  1136.   you actually use. JAYAR Systems depends upon and needs your support. Thank
  1137.   you!
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.                                                      Trial Use License:   17
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.                              D Trial Use License: 
  1182.  
  1183.  
  1184.   JRchive is NOT a public domain program. It is Copyright (C) 1992-93 by
  1185.   JAYAR Systems. All rights reserved.
  1186.  
  1187.         This software and accompanying documentation are protected by
  1188.   Canadian Copyright law and also by International Treaty provisions. Any use
  1189.   of this software in violation of Copyright law or the terms of this limited
  1190.   license will be prosecuted to the best of our ability. The conditions under
  1191.   which you may copy this software and documentation are clearly outlined
  1192.   below under "Distribution Restrictions".
  1193.  
  1194.         JAYAR Systems hereby grants you a limited license to use this
  1195.   software for evaluation purposes for a period not to exceed sixty (60)
  1196.   days. If you intend to continue using this software (and/or it's
  1197.   documentation) after the sixty (60) day evaluation period, you MUST make a
  1198.   registration payment to JAYAR Systems.
  1199.  
  1200.         Using this software after the sixty (60) day evaluation period,
  1201.   without registering the software is a violation of the terms of this
  1202.   limited license.
  1203.  
  1204.         Licensee shall not use, copy, rent, lease, sell, modify, decompile,
  1205.   disassemble, otherwise reverse engineer, or transfer the licensed program
  1206.   except as provided in this agreement. Any such unauthorized use shall
  1207.   result in immediate and automatic termination of this license.
  1208.  
  1209.         All rights not expressly granted here are reserved to JAYAR Systems.
  1210.  
  1211.         For information on registering your copy of JRchive see Appendix 6,
  1212.   "How to Register."
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.                                           Limited Distribution License:   18
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.                        E Limited Distribution License: 
  1242.  
  1243.  
  1244.   As the copyright holder for JRchive, JAYAR Systems authorizes distribution
  1245.   by individuals only in accordance with the following restrictions.
  1246.  
  1247.         (User Groups, Computer Clubs, Disk Vendors and Distributors,
  1248.   Subscription Services, Disk-of-the-Month Clubs, etc., should refer to the
  1249.   VENDOR.DOC file for complete information relating to them.)
  1250.  
  1251.         (BBS SYSOPs should refer to the SYSOP.DOC file for complete
  1252.   information relating to them.)
  1253.  
  1254.         Individuals are hereby granted permission by JAYAR Systems to copy
  1255.   the JRchive diskette for their own use (for evaluation purposes) or for
  1256.   other individuals to evaluate, ONLY when the following conditions are met.
  1257.  
  1258.         The JRchive package is defined as containing all the material listed
  1259.   in the PACKING.LST text file. If any files listed in the PACKING.LST text
  1260.   file, or the PACKING.LST file itself, are missing, then the package is not
  1261.   complete and distribution is forbidden. Please contact us to obtain a
  1262.   complete package suitable for distribution.
  1263.  
  1264.     o The JRchive package--including all related program files and
  1265.       documentation files--CANNOT be modified in any way and must be
  1266.       distributed as a complete package, without exception. The PACKING.LST
  1267.       text file contains a list of all files that are part of the JRchive
  1268.       package.
  1269.  
  1270.     o No price or other compensation may be charged for the JRchive package.
  1271.       A distribution cost may be charged for the cost of the diskette,
  1272.       shipping and handling, as long as the total (per disk) does not exceed
  1273.       $10.00.
  1274.  
  1275.     o The JRchive package CANNOT be sold as part of some other inclusive
  1276.       package. Nor can it be included in any commercial software packaging
  1277.       offer, without a written agreement from JAYAR Systems.
  1278.  
  1279.     o The PRINTED User's Guide may not be reproduced in whole or in part,
  1280.       using any means, without the written permission of JAYAR Systems. In
  1281.       other words, the disk-based documentation may not be distributed in
  1282.       PRINTED (hardcopy) form.
  1283.  
  1284.     o The JRchive package cannot be "rented" or "leased" to others.
  1285.  
  1286.     o Licensee shall not use, copy, rent, lease, sell, modify, decompile,
  1287.       disassemble, otherwise reverse engineer, or transfer the licensed
  1288.       program except as provided in this agreement. Any such unauthorized use
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.                                           Limited Distribution License:   19
  1296.  
  1297.  
  1298.       shall result in immediate and automatic termination of this license.
  1299.  
  1300.     o U.S. Government Information: Use, duplication, or disclosure by the
  1301.       U.S. Government of the computer software and documentation in this
  1302.       package shall be subject to the restricted rights applicable to
  1303.       commercial computer software as set forth in subdivision (b)(3)(ii) of
  1304.       the Rights in Technical Data and Computer Software clause at
  1305.       252.227-7013 (DFARS 52.227-7013). The Contractor/manufacturer is JAYAR
  1306.       Systems, 253 College Street, Suite 263, Toronto, Ontario, CANADA M5T
  1307.       1R5.
  1308.  
  1309.         All rights not expressly granted here are reserved to JAYAR Systems.
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.                                                 Definition of Shareware   20
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.                           F Definition of Shareware 
  1362.  
  1363.  
  1364.         Shareware distribution gives users a chance to try software before
  1365.   buying it. If you try a Shareware program and continue using it, you are
  1366.   expected to register. Individual programs differ on details--some request
  1367.   registration while others require it, some specify a maximum trial period.
  1368.   With registration, you get anything from the simple right to continue using
  1369.   the software to an updated program with printed manual.
  1370.  
  1371.         Copyright laws apply to both Shareware and commercial software, and
  1372.   the copyright holder retains all rights, with a few specific exceptions as
  1373.   stated below. Shareware authors are accomplished programmers, just like
  1374.   commercial authors, and the programs are of comparable quality. (In both
  1375.   cases, there are good programs and bad ones!) The main difference is in the
  1376.   method of distribution. The author specifically grants the right to copy
  1377.   and distribute the software, either to all and sundry or to a specific
  1378.   group. For example, some authors require written permission before a
  1379.   commercial disk vendor may copy their Shareware.
  1380.  
  1381.         Shareware is a distribution method, not a type of software. You
  1382.   should find software that suits your needs and pocketbook, whether it's
  1383.   commercial or Shareware. The Shareware system makes fitting your needs
  1384.   easier, because you can try before you buy. And because the overhead is
  1385.   low, prices are low also. Shareware has the ultimate money-back
  1386.   guarantee--if you don't use the product, you don't pay for it.
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.                              ASP OMBUDSMAN POLICY
  1393.  
  1394.         This program is produced by a member of the Association of Shareware
  1395.   Professionals (ASP). ASP wants to make sure that the shareware principle
  1396.   works for you. If you are unable to resolve a shareware-related problem
  1397.   with an ASP member by contacting the member directly, ASP may be able to
  1398.   help. The ASP Ombudsman can help you resolve a dispute or problem with an
  1399.   ASP member, but does not provide technical support for members' products.
  1400.   Please write to the ASP Ombudsman at 545 Grover Road Muskegon, MI 49442 or
  1401.   send a CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536.
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.                                                         How to Register   21
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.                               G How to Register 
  1422.  
  1423.  
  1424.   JRchive is a "shareware program" and is provided at no charge to the user
  1425.   for evaluation. Feel free to share it with your friends, but please do not
  1426.   give it away altered or as part of another system. The essence of
  1427.   "user-supported" software is to provide personal computer users with
  1428.   quality software without high prices, and yet to provide incentive for
  1429.   programmers to continue to develop new products. If you find this program
  1430.   useful and find that you are using JRchive and continue to use JRchive
  1431.   after a reasonable trial period, you must make a registration payment of
  1432.   US$29.00 (Cdn$34.00) to JAYAR Systems. The registration fee will license
  1433.   one copy for use on any one computer at any one time.
  1434.  
  1435.         When you register you receive the following:
  1436.  
  1437.     o You will get the latest version of JRchive,
  1438.  
  1439.     o The registered version of JRchive does not display a banner
  1440.       (registration reminder notice) when it runs,
  1441.  
  1442.     o You will get a typeset manual,
  1443.  
  1444.     o You will get the utilities CUT and PASTE. CUT breaks up large files
  1445.       into pieces which fit on a diskette. PASTE reassembles them. An ideal
  1446.       utility for developers and distributors.
  1447.  
  1448.     o You will be informed of updates and given a reduced upgrade cost.
  1449.  
  1450.         You must treat this software just like a book. An example is that
  1451.   this software may be used by any number of people and may be freely moved
  1452.   from one computer location to another, so long as there is no possibility
  1453.   of it being used at one location while it's being used at another. Just as
  1454.   a book cannot be read by two different persons at the same time.
  1455.  
  1456.         Commercial users of JRchive must register and pay for their copies of
  1457.   JRchive within 30 days of first use or their license is withdrawn. Your
  1458.   registration fee purchases a single user license. If you need to use
  1459.   multiple copies, significant savings can be had by purchasing a site
  1460.   license rather than registering multiple individual copies. Even a two-user
  1461.   site license saves you money. See the file SITELICE.DOC for details.
  1462.  
  1463.         Anyone distributing JRchive for any kind of remuneration must first
  1464.   contact JAYAR Systems at the address given in DESCRIBE.DOC for
  1465.   authorization. This authorization is automatically granted to distributors
  1466.   and vendors who are members of the Association of Shareware Professionals
  1467.   (ASP). See files VENDOR.DOC and SYSOP.DOC for details.
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.                                                         How to Register   22
  1476.  
  1477.  
  1478.         You are encouraged to pass a copy of JRchive along to your friends
  1479.   for evaluation. Please encourage them to register their copy if they find
  1480.   that they can use it. All registered users will receive a copy of the
  1481.   latest version of the JRchive system.
  1482.  
  1483.         Send in the following form to register your copy of JRchive:
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.   REGISTRATION FORM
  1534.   Send to:  JAYAR Systems                  GST Registration Number:
  1535.             253 College Street             R124607193
  1536.             Suite 263
  1537.             Toronto, Ontario
  1538.             Canada   M5T 1R5
  1539.  
  1540.   Name       ___________________________________________
  1541.  
  1542.   Address    ___________________________________________
  1543.  
  1544.              ___________________________________________
  1545.  
  1546.              ___________________________________________
  1547.  
  1548.              ___________________________________________
  1549.  
  1550.   Telephone  __________________________
  1551.  
  1552.   +--------+------------------------+------------+------------+
  1553.   |Quantity| Product                | Each       |   Total    |
  1554.   +--------+------------------------+------------+------------+
  1555.   |        |                        |  US$29.00  |            |
  1556.   |        | JRchive                |     or     |            |
  1557.   |        |                        | Cdn$34.00  |            |
  1558.   +--------+------------------------+------------+------------+
  1559.   |               Canadian residents add 7% GST  |            |
  1560.   +----------------------------------------------+------------+
  1561.   |                Ontario residents add 8% PST  |            |
  1562.   +----------------------------------------------+------------+
  1563.   |      Outside Canada/U.S.A.,   add shpg/hndlg |   $5.00    |
  1564.   +----------------------------------------------+------------+
  1565.   |                                       TOTAL  |            |
  1566.   +----------------------------------------------+------------+
  1567.  
  1568.   Please remit by cheque (we will accept cheques in your local currency at
  1569.   the appropriate rate of exchange) or by money order.  We will accept your
  1570.   company's purchase order.  We also accept payment by Visa or Mastercard.
  1571.  
  1572.   P.O. Number  ______________________________________ (P.O. to follow)
  1573.  
  1574.        +------------------------------------------------------------------+
  1575.        | Note - Fill out the following ONLY if you are making payment by  |
  1576.        |        credit card.  You may also call (416) 751-5678 for credit |
  1577.        |        card registrations.                                       |
  1578.        |                                                                  |
  1579.        | Master Card [ ]  Visa [ ] Card Number ______ ______ _____ ______ |
  1580.        |                                                                  |
  1581.        | Name on the Card (print) _______________________________________ |
  1582.        |                                                                  |
  1583.        | Expires ____/____                                                |
  1584.        |                    Signature ___________________________________ |
  1585.        |                                                                  |
  1586.        +------------------------------------------------------------------+
  1587.